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INTRODUCTION 

This guide for operating the paper tape version of the PDP-9 ADVANCED Software System is 
planned for convenient use at the computer. It contains general operating instructions, as well as con- 
cise summaries of operating procedures for individual system programs. For more detailed descriptions 
of the monitor and system programs, the reader is referred to the following PDP-9 ADVANCED Software 
System manuals. 

Manual Document Number 



Utility Programs DEC-9A-GUAB-D 

MACRO-9 DEC-9A-AM9B-D 

FORTRAN-IV DEC-9A-AF4B-D 

Monitors DEC-9A-MAD0-D 



1. LOADING PROGRAMS 

In the paper tape system, each system program, accompanied by the necessary l/O device 
handlers and an appropriate version of the l/O Monitor, resides on a separate paper tape in absolute 
format. The eight system tapes supplied are: 

FORTRAN IV 

MACRO-9 

PIP-9 

Editor (EDIT-9) 

Linking Loader (LINK-9) 

DDT -9 (without patch file capabilities) 

DDT-9 (with patch file capabilities) 

7-T0-9 Converter (CONV-9) 

To load these programs, place the tape in the reader, set the loading address in the console 
address switches, press the tape feed button, depress I/O RESET, and then depress the READ IN switch. 

The loading addresses are: 

17720 for 8K systems 

37720 for 16K systems 

57720 for 24K systems 

77720 for 32 K systems 
Either the Linking Loader or DDT-9 may be used to load user programs. 



2. SYMBOLS (Used in This Manual) 



J Represents carriage return.. 

u_, Represents space. 

t Echoed on Teletype for CTRL 

(control key) functions. 




1. LOADING INSTRUCTIONS 

Place the FORTRAN IV Compiler tape in the paper tape reader, depress the tape-Feed switch 
to clear the end-of-tape flag, set the address switches to 17720 (8K), and depress I/O RESET and 
READ IN. 

When FORTRAN IV has been loaded, it types 

FORTRAN 4 
> 

on the Teletype and waits for a command string from the user. 



GENERAL COMMAND CHARACTERS 

RUBOUT (echoes \) 
CTRL U (echoes @) 
CTRL P (echoes t-P) 



Delete single character. 
Delete entire line. 

a) If end of pass 1 , begin pass 2. 

b) If compiler is running, restart 
at beginning of pass 1 . 



3. 



where 



COMMAND STRING 

The format expected by the FORTRAN IV command string processor is as follows: 



Options 
O, S, L, B 

O = object listing 

S = symbol map 
L = source listing 
B = binary 



File Name 



FILEX 



•Must be a legal 
FORTRAN name. 



Terminator 

^ or^ALT MODE, 

Halts after compiling 
current program 



r 



Indicates batch compilation; 

after compiling current program, 

types 

FORTRAN 4 

> 

and waits for next command string, 



The options may be used in any combination (or none at all). The options desired may appear 
in any order, separated by commas and terminated by *-. If none of the options are desired, *- is suf- 
ficient, with the sole output being compiler diagnostics on the Teletype. Rubouts may be used to de- 
lete unwanted characters, and CTRL U to delete entire lines, prior to typing the command string 
terminator. 

4. RUNNING INSTRUCTIONS 



After the compiler is loaded into core. 



a. Place the source program tape in the paper tape reader, and momentarily depress the 
tape-feed switch. 

b. Type the command string. 

c. At the end of Pass 1 (when the END statement is encountered for the first time), 
FORTRAN IV types: 

END PASS 1 

t P 

d. Reload the source tape for Pass 2 and momentarily depress the tape-feed switch. 

e. Initiate Pass 2 by typing CTRL P. 



5. ERROR CONDITIONS AND RECOVERY 

lOPS 4, device not ready. Check devices, correct condition, and type CTRL R, 
lOPS 00-30, see Appendix 5 for system restart procedures. 
See Appendix 7 for a list of compiler errors. 

6. RESTART PROCEDURES 



CTRL P, restart the compiler, if running. 

See Appendix 5 for system restart procedures if FORTRAN IV has halted. 

7. E XAMPLES 

a. To compile a source tape with none of the options, type the command string: 

-FILEX,^ 
This is very useful for a first compilation when only error messages are desired. 

b. If the output desired is a binary tape, type the command string: 

B -FILEX.^ 

c. If the output desired is a complete listing, type the command string: 

SLO -FILEX,/' 




LOADING INSTRUCTIONS 

Place the MACRO-9 Assembler tape in the paper tape reader, depress the tape-feed switch 
to clear the end-of-tape flag, set address switches to 17720 (8K), and depress l/O RESET and READ IN, 
When MACRO-9 has been loaded, it types 

MACRO 
> 
on the Teletype and waits for a command string from the user. 



2. 



GENERAL COMMAND CHARACTERS 

RUBOUT (echoes \) 
CTRL U (echoes @) 
CTRL P (echoes tP) 



Delete single character. 
Delete complete line. 

a) If end of pass 1 , begin pass 2. 

b) If assembler is running, restart 
at beginning of pass 1 . 



3. 



where 



COMMAND STRING 

The format expected by the MACRO-9 command string processor is as follows: 



Options 
P, S, L, B 



File Name 
FILEX 



P = parameters to be entered on teletype 
S = symbol table (on listing device) 
L = listing 
B = binary 



Terminator 

•^ or ALT MODE 

Halts after assembling current 
program . 



r. 



Vs. 



Return to MACRO-9 after assembling 
current program, types 

MACRO 

> 
and waits for next assembly command 
string. 



Options may be used in any combination (or none at all). The options may appear in any 
order, separated by commas and terminated by -^ . If no options are desired, *- is sufficient and the 
sole output will be assembly error messages on the Teletype. Rubouts may be used to delete unwanted 
characters, and CTRL U (tU) to delete entire lines, prior to typing the command string terminator. 



4. RUNNING INSTRUCTIONS 

After fhe Assembler is in core, 

a. Place the user program source tape in the paper tape reader, and momentarily depress 
the tape-feed switch. 

b. Type the command string. 

c. At the end of Pass 1 (when the .END statement is encountered for the first time) 
MACRO types 

END OF PASS 1 
tP 

d. Reload the source tape for Pass 2 and momentarily depress the tape-feed switch. 

e. Initiate Pass 2 by typing CTRL P. 

If this is a multi-tape assembly (where the first n source tapes are terminated with .EOT and 
the last is terminated with .END), MACRO-9 indicates the end of each tape by typing .EOT on the 
Teletype. This allows the user to load the next source tape (depress the tape-feed control) and then 
type CTRL P. 

If the P option was used, the parameters are entered only at the beginning of Pass 1 and not 
again for Pass 2. 

5. ERROR CONDITIONS AND RECOVERY PROCEDURES 



lOPS 4, device not ready. Check devices, correct condition and type CTRL R. 

lOPS 00-30, see Appendix 5 for procedures. 

See Appendix 3 for a list of MACRO-9 error diagnostics. 

6. RESTART PROCEDURES 

CTRL P, restart MACRO-9, if running. 

See Appendix 5 for system restart procedures if MACRO-9 has halted. 

7. EXAMPLES 



a. To assemble a source tape with none of the options, type the command string: 

-FILEXi/ 
This is very useful for the first assembly of a program, when only error messages are desired. 

b. If the output desired is a binary tape and input includes parameters to be entered on the 
Teletype, type the command string: 

P, B-FILEX,; 



The parameters should be entered during the first pass only. Parameters are typed following 
the command string, in the form of MACRO-9 direct assignment statements. After typing in parameters, 
the user types CTRL D, as shown in the example below. 

BANK = 

CTRL D 

MACRO then types 

EOT 

tP 

the user should then type CTRL P when ready to proceed. 

c. If the output desired is a complete listing but no binary tape, type the command string: 

S, L-FILEX,; 




PIP-9 



1 



LOADING INSTRUCTIONS 



Place the PIP tape In the paper tape reader, depress the tape-feed switch to clear the end- 
of-tape flag, set the address switches to 17720 (8K), and depress l/O RESET and READ IN. 
When PIP-9 has been loaded, it types: 

PIP 

> 

on the Teletype and waits for a command string from the user. 



GENERAL COMMAND CHARACTERS 

RUBOUT (echoes \) 
CTRL U (echoes (o^) 
CTRL P (echoes tP) 



Delete single character, 
Delete entire line. 
Restart PIP. 



3. 



COMMAND STRING 



The general format of a PIP command string is as follows: 

F DD (S) -SD 

terminated by a carriage return or ALT MODE. 

F is a function character, which may be: 

T = transfer file 

V= verify file 

S = segment file 
DD is the destination device. 

PP = paper tape punch 

TT = teletype 

LP = line printer 
(S) indicates the switch options. 
Data Mode Switches: 

A= lOPS ASCII 

B = lOPS binary 

I = Image Alphanumeric 



Function switches: 

G = correct bad parity lines 

E = convert tabs to spaces 

C = convert multiple spaces to tabs 

T = delete trailing spaces 

Q = delete sequence numbers 

F = insert form feeds 

Y = segment files (with n output tapes, use n-1 commas after PP) 

W = combine files (with n input tapes, use n-1 commas after PR) 
The back arrow (♦-) terminates information concerning the destination device. Data for the 
source device follows the back arrow. 
SD is the source device. 

PR = paper tape reader 

TT = teletype 

CD = card reader 
Carriage return or ALT MODE is the command string terminator: 

Carriage Return - return to PIP after completion of the current function. 

ALT MODE - halt after completion of the current function. 
Rubouts may be used to delete unwanted characters, and CTRL U to delete the entire line, 
prior to typing the command string terminator. 



4. OPERATING INSTRUCTIONS 

Legal function/switch combinations 

Transfer (T): all switches legal 

ASCII mode (A): 



Binary mode (B): 
Image mode (I): 

Verify (V): 

Segment (S): 



all function switches legal 

E, C, and T are contradictory; 

Y and W are contradictory 

Q may be combined with E, C, or T, 

function switch W only 

no function switches legal 

switches A and B only 

no switches legal 



5. ERROR CONDITIONS AND RECOVERY PROCEDURES 

lOPS 4 device not ready Ready device and type CTRL R. 

lOPS 00-30 See Appendix 5 for system restart procedures, 

6. RESTART PROCEDURES. 



CTRL P, Restart PIP, if running 

See Appendix 5 for system restart procedures if PIP has halted. 



7. EXAMPLES 



a. To reproduce an ASCII tape: 

T^PP^(A)^-^PR*; 
Transfer to the paper tape punch from the paper tape reader in lOPS ASCII mode. 

b. To list an ASCII tape: 

T^TT_(A)^-^PR^ 

c. To combine 3 binary subprogram tapes into one tape: 

Tu_PP^(BW)^-^PR,,^ 

Since the W switch is on, the three binary tapes will be combined into one file, with 
the intermediate EOF's deleted. The final EOF is retained. This provides a very convenient method 
for creating a Library file. 

d. To verify a binary tape: 

V_PR_(B)^ 

Checksum and parity verification are performed on the input binary tape. There will 
be no output. If a parity error occurs, the following message is typed: 

INPUT PARITY ERROR 

If a checksum error: 

INPUT CHECKSUM FAILURE 

e. To check parity: 

T^PP^(AG)^-^PR^ 

Transfer files from paper tape to paper punch in ASCII mode with G switch to check for 
parity errors. 

For actions to be taken if a parity error is encountered, refer to the explanation for 
G switch. 

f. To reproduce a binary tape: 

T^P._(B)u^-L_PR^ 
Transfer files from paper tape reader to paper tape punch in binary mode. 
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g. To reproduce in Image mode: 

Transfer files from paper tape reader to paper tape punch in image ASCII mode. This is 
the only way to reproduce a tape with channel 7 punches. 

h. To segment a tape: 

S^TAGA, TAGB, TAGC «> 

Sets up the segmentation points. 

T^PP,,,(AY)-PR^ 

Transfers from paper tape reader to paper tape punch, providing EOT and blank tape 
(ust before each indicated tag. 

t P is output PIP at the end of each segment. When ready to continue, type CTRL P. 

i. To transfer from cards to ASCII paper tape and delete trailing spaces and sequence 
numbers: 

T^PPUATQ)^-^CD^ 

j. To insert a form feed every 56 lines or after every .EJECT: 
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EDITOR 



1. 



LOADING INSTRUCTIONS 



Place the Editor tape in the reader, depress the tape-feed switch to clear the end-of-tape 
flag, set the address switches to 17720 (8K), and depress I/O RESET and READ IN. When the Editor 
has been loaded, it types 

EDITOR 
> 
on the Teletype and waits for a command string from the user. (It is initially in Edit Mode, and Block 
Mode is ON.) The user may either create a file or edit an existing file. 



2. 



GENERAL COMMAND CHARACTERS 



RUBOUT (echoes \) 
CTRL U (echoes @) 
CTRL P (echoes t P) 



Delete single character. 
Delete entire line. 
Restart the editor. 



3. 



COMMAND STRING 



Not applicable 



4. 



OPERATING PROCEDURES 



Editing Operation 1: Creating a file. 



User Types In 



Content of the program 
(each line is terminated 
by.') 

J (necessary before close) 



CLOSE 



Action 
INPUT 

Punches out previous 
line typed. 

EDIT 
> 

punches blank tape 

EDITOR 

> 



Effect 

Mode is changed from Edit 
to Input. 

Line typed in is processed. 



Change from Input to Edit 
Mode. 

Finishes the current file. 
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Editing Operation 2: Modifying an existing file: 

a. Place the source tape in the reader. 

b. Depress tape-feed switch. 



c. Type a READ command followed by any command desired. See summary of Edit com- 
mands listed below. 



SUMMARY OF EDITING COMMANDS 
Command Abbreviation 



File Housekeeping Requests 
CLOSE 

Locative Requests 



FIND string 

LOCATE string 

NEXT 

BOTTOM 
TOP* 

PRINT 

Manipulative Requests 
DELETE 
RETYPE string 
INSERT string 

CHANGE/stringl/string2/ 

OVERLAY 
APPEND string 

Mode Control 



VERIFY jON 
LOFF 



n/a 



N 

B 
T 

P 

D 
R 



O 
A 



V 



Activity 



Terminate editing on input file, 



Bring first line beginning with 
"string" to work area. 

Bring first line containing "string' 
to work area. 

Bring next consecutive line to 
work area. 

Bring last line to work area. 

Reset pointer to beginning of 
block. 

Print the current line on Teletype, 



Discard the current line. 

Replace current line with "string" 

Add "string" as a complete line, 
after (below) the current line. 

Replace, in the current line, the 
first occurrence of "string] " with 
"string2". 

Replace multiple lines. 

Add "string" of the rightmost 
end of the current line. 



Set verify mode to print (ON) or 
ignore printing (OFF) lines after 
processing CHANGE, LOCATE, 
FIND and BOTTOM requests. 



'May be used only with BLOCK mode ON. 
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Command 
Mode Control (Cont) 



BLOCK 


ON 




\OFF 


BRIEF 


fON 




\OFF 


OUTPUT 


/ON 




lOFF 



Input/Output Requests 



Miscellaneous Requests 
SIZE 



Abbreviation 
n/a 

n/a 
n/a 



READ* 


n/a 


WRITE* 


n/a 


GET 


G 



INSERT 



Activity 



Set program to operate in block 
mode (ON) or in line-by-line 
mode (OFF). 

Set brief mode to print truncated 
(ON) or full (OFF) lines. 

Set to ON when Editor is loaded 
into core. When set to OFF, user 
may examine any section in the 
input file without causing output. 



Fill block buffer from input file. 

Add block buffer to output file. 

Add lines from subsidiary input 
device after (below) current line. 



Set total lines to occupy block 
buffer. 

Change mode to input. 



5. 



ERROR CONDITIONS AND RECOVERY PROCEDURES 

a. END OF {FILE BUFFERS} REACHED BY: 
NEXT n 



Results if the command results in the 
pointer moving past the last line of 
the file or buffer. 

b. END OF {FILE BUFFER} REACHED 
BY: 

PRINT n 

c. END OF MEDIUM REACHED BY: 

GET n 

If the end-of-medium condition is 
encountered on the subsidiary input 
device before n lines are read. The 
pointer remains at the last line read. 



a) If editing in line-by-line mode, use com- 
mand CLOSE and reload the input tape. 

b) If in block mode, move the pointer to the 
top of the buffer (T 1/ ) . 



For recovery, do exactly as above. 



Place the original paper tape back in the 
reader where it left off and continue editing, 



*May be used only with BLOCK mode ON. 
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d. NOT A REQUEST 

P3 1^ P^ 3 *> 

Blank required between command and argument. 

e. NOT A REQUEST 

^ . is not recognized by the Editor 

as a symbol with correct counter value. 

f. READ ERROR: 

Parity or checksum error in indicated 
line. 

g. TRUNCATED: 

Indicated line greater than 90 
characters. 



NOTE 

The user has a choice, following either of the above errors, 
of either modifying the line that caused the error (via any 
manipulative request) or of allowing the line to remain as 
it is in the output file (via any locative request). 



h. NOTHING IN FILE: 

Caused by issuing a CLOSE command 
prior to a WRITE command with Block 
Mode ON; or OUTPUT is turned OFF 
when a WRITE or CLOSE command is 
issued. In either case, control returns 
to the Editor and the contents of the 
buffer are unchanged. 

i. IOPS4 

Device not ready: ready device and 
type CTRL R (tR). 

j. lOPS 00-30 see Appendix 5 for sys- 
tem restart procedures. 



6. RESTART PROCEDURES 



CTRL P, restart Editor if running. 

See Appendix 5 for system restart if the 

Editor has halted. 
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7. 



EXAMPLES 



Original 
JMPTAGl 

JMS* LOOP 

H DAC^CNTR 



Desired Change 
JMS TAG 1 

JMS LOOP 



or 



H DACt_.CNTR/counter 
check 



Purpose 

To change one char- 
acter in a word 

To eliminate one 
character in a word 

To add a string of 
characters at the end 
of a line 

To print the current P J 

line 

To read the next line N ^ 

To change mode (from j 

edit to input or vice 

versa) 

CLOSE should always be the last command issued to complete editing. 

How to Use BLOCK MODE: 

User types in: 

Set up Mode 

N = number of lines in block 

N lines are brought in core 

output all lines onto paper tape punch 

back to line by line editing 



Correct Format Com- 
mand (user types In) 

C^/P/S/ 

c^/svs/ 

A,_j/counter check 



BLOCK^ON./ 
SIZE^N*' 
READ.; 
WRITE J 
BLOCK OFF*; 
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1. 



LOADING INSTRUCTIONS 



Place the Converter tape in the paper tape reader, depress the tape-feed switch to clear the 
end-of-tape flag, set the address switches to 17720 (8K), and depress I/O RESET and READ IN. When 
the Converter has been loaded, it types 

7-TO-9 CONVERTER 

> 
on the Teletype and waits for a command string from the user. 



2. 



GENERAL COMMAND CHARACTERS 
RUBOUT (echoes \) 

CTRL U (echoes©) 
CTRL P (echoes tP) 



Delete last character in command 

string - may be repeated n times to delete 

n characters. 

Delete entire line. 

a) Reinitialize converter. 

b) Resume operation after placing 
new tape in reader. 



3. 



where 



COMMAND STRING 

The format expected by the Converter command string processor is as follows: 



Options 
L,A,R,E,Tn 



File Name 

^flLE^ 

Output program 
name 



Terminator 



L = listing 

A = Insert .ABS pseudo op 

R = remove origin settings 

E = .EOT instead of .END 

T = combine input tapes 

n = decimal number of input tapes 



,; or .ALT MODE, 



Halt after converting. 

Return to the converter to perform 
more conversions, types 
{ 7-TO-9 CONVERTER 
> 



V. 



and waits for next string 



Options may be used in any combination (or none at ail). The options desired may appear 
in any order, separated by commas and terminated by ^ . If no options are wanted, -^ is sufficient. 
Rubouts may be used to delete unwanted characters, and CTRL U to delete entire lines prior to typing 
the command string terminator. If an error in the command string is detected, the converter types: 



17 



COMMAND STRING ERROR 
> 



and waits for a new command string. 



4. 



OPERATING INSTRUCTIONS 



The Input tape to be converted must be ready in the reader (depress the tape-feed switch to 
clear the end-of-tape flag) before the command string terminator is typed. When the end of the input 
tape is reached, the converter punches several inches of blank tape; then do one of the following: 

a. If a carriage return was used in the command string, the converter re-initializes, types 

7-TO-9 CONVERTER 
> 
and waits for another command string. 

b. If an ALT MODE was used in the command string, the computer halts. If the Tn option 
has been used to combine a number of tapes into one tape, the converter will type tP at the end of 
each tape except the last. Place the next tape in the reader, depress the tape feed switch to clear the 
end-of-flag and type CTRL P. Note that the Converter does not punch any blank tape at this time. 



5. 



ERROR CONDITIONS 

COMMAND STRING ERROR 
IOPS4 

lOPS 00-30 



Retype command string. 

Device not ready (possibly punch out of 
tape). Ready device and type CTRL R. 

See Appendix 5 system restart procedure, 



6. 



RESTART PROCEDURE 

CTRL P Reinitialize converter. 

See Appendix 5 for system restart procedures if the converter has halted. 

EXAMPLES 



To convert a single paper tape to be assembled in the absolute mode with no listing, the 
command string would be 

A -NAME*; 
To combine three tapes into one ending with .EOT, to be assembled relocatably (but with 
locations settings) and to obtain a listing; the command string would be: 

L, E, T3-NAME^ 
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1. 



LOADING PROCEDURE 



Place the Linking Loader tape in the paper tape reader, depress the tape feed switch to clear 
the end-of-tape flag, set the address switches to 17720 (8K), and depress I/O RESET and READ IN. 
When the Loader has been loaded, it types 

LOADER 
> 
on the Teletype and waits for a command string from the user. 



2. 



GENERAL COMMAND CHARACTERS 
RUBOUT (echoes \) 

CTRL U (echoes®) 
CTRL P (echoes tP) 



CTRL S (echoestS) 



Delete last character typed, n rubouts 
may be used to delete n characters within 
a line. 

Delete entire line. 

a) Restart the Loader (when typing program 
names). 

b) Continue loading (when paper tape is 
ready) . 

Start user's program. 



3. 



COMMAND STRING 



The command string may have several different forms as follows: (The >'s are supplied by 

the loader.) 

>NAME1, NAME2, NAMES (ALT MODE) 

or 

>NAME1 J 

> NAME2 J 

>NAME3 (ALT MODE) 

or 

>,, (ALT MODE) 

It is important to accurately specify the number of programs (n) to be loaded with n-1 com- 
mas or carriage returns before the ALT MODE. 



4. 



OPERATING PROCEDURES 



Place the main program in the reader, depress the tape feed switch to clear the end-of-tape 
flag, and then enter the command string. 
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When the main program has been loaded, the loader types tp. Place any subroutines to be 
loaded in the reader, depress the tape feed switch, and type CTRL P. 

When all subroutines have been loaded, place the I/O library (tape 1 of 3) in the reader, 
depress the tape feed switch, and type CTRL P. 

MACRO programs (that do not require programs from the FORTRAN library): 

If the loader has not been satisfied at the end of the I/O library, place the short 

EOF tape (included with library tape) in the reader, push the feed button and type 

CTRL P. 

FORTRAN programs (and MACRO programs that require programs from the FORTRAN library): 

After the l/O library has been read, load the FORTRAN library (tapes 2 and 3) in the same 

manner (Tape 3 includes EOF). 

If the loader is not satisfied by the library tapes, a subroutine has been omitted. The loader 
types out the names and addresses of all programs and library subroutines loaded. A . LOAD 3 error 
message and a zero address indicates a missing subroutine. (If this happens, it is necessary to reload 
the LOADER.) When loading has been successfully completed, the loader types tS. Ready all l/O 
devices required and type CTRL S to start execution. 

5. ERROR MESSAGES 



. LOAD 1 
. LOAD 2 
. LOAD 3 
. LOAD 4 
.IOPS4 

.lOPS 00-30 



Memory overflow 

Input data error 

Unsatisfied global symbol (missing program) 

Illegal .DAT slot request by user program 

Device not ready. Ready device and type 
CTRL R. 

Unrecoverable I/O error 



6. 



RESTART PROCEDURE 



To restart the Loader before the command string has been terminated by ALT MODE, type 
CTRL P. After the command string has been accepted by the Loader, there is no restart procedure; the 
Loader must be reloaded. 



7. 



EXAMPLES 

LOADER 

>EX1 (ALT MODE) 
EXl 17365 
tS Type control S to start program 
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LOADER 



>(ALT MODE) 
EXl 17365 

tS 



Program name not needed with paper tape 
input to loader. 



LOADER 



>EX2,SUB (ALT MODE) 


EX2 


17656 


tPtP 




SUB 


17613 


tPtP 




tPtP 




.DA 


17544 


tPtP 




BCDIO 


14551 


STOP 


14536 


SPMSG 


14442 


FIOPS 


13712 


OTSER 


13604 


REAL 


12651 


ts 





Place subroutine in reader and type control P. 

Place I/O library in reader and type control P. 
Place FORTRAN library tape 2 in reader and type 
control P 

Place FORTRAN library tape 3 in reader and type 
control P 

NOTE 

After placing tape in reader, push the tape feed button 
to clear the end-of-tape flag. First tP is signal to load 
next tape. Second tP is acknowledgment of user typing 
control P. 



LOADER 



>, (ALT MODE) 


EX2 


17656 


tPtP 




SUB 


17613 


tPtP 




tPtP 




.DA 


17544 


tPtP 




BCDIO 


14551 


STOP 


14536 


SPMSG 


14442 


FIOPS 


13712 


OTSER 


13604 


REAL 


12651 


ts 





Program names not needed with paper tape input to loader, 



LOADER 



>EX2*' 




>SUB (ALT MODE) 


EX2 


17656 


tPtP 




SUB 


17613 


tPtP 




tptP 




.DA 


17544 


tPtP 





Carriage return may be used in place of comma, 
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BCDIO 


14551 


STOP 


14536 


SPMSG 


14442 


FIOPS 


13712 


OTSER 


13604 


REAL 


12651 


ts 





LOADER 



> (ALT M( 


DDE) 


EX2 


17656 


tPtP 




tPtP 




tPtP 




BCDIO 


14663 


STOP 


14650 


SPMSG 


14554 


FIOPS 


14024 


OTSER 


13716 


REAL 


12763 


SUBROT 


00000 


. LOAD 3 





The subroutine was omitted, 
Unsatisfied global symbol. 
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DDT-9 



1. 



LOADING PROCEDURES 



Place the DDT tape (which includes the Linking Loader) in the paper tape reader, depress 
the tape feed switch to clear the end-of-tape flag, set address switches to 17720 (8K), and depress 
I/O RESET and READ IN. When DDT has been loaded, it types 

LOADER 

> 
on the Teletype and waits for a user command string to load the program to be debugged. 



2. 



GENERAL COMMAND CHARACTERS 
RUBOUT (echoes \) 

(echoes®) 
CTRL U (echoes®) 

CTRLP (echoes tP) 



CTRLT (echoestT) 



a) During load phase - delete last char- 
acter typed, n rubouts may be used 
to delete n characters within a line. 

b) In DDT, delete all characters typed. 

During load phase only, delete entire 
line. 

a) Restart the Loader (when typing pro- 
gram names). 

b) Continue loading (when next paper 
tape is ready). 

Restart DDT or bypass loading. 



3. 



COMMAND STRING - LOADER PHASE 



The command string may have several different forms as follows: (the >'s are supplied by 

Loader portion of DDT). 

>NAME1, NAME2, NAMES (ALT MODE) 

or 

>NAME1 J 

>NAME2 J 

>NAME3 (ALT MODE) 

or 

>,, (ALT MODE) 

It is important to accurately specify the number of programs (n) to be loaded with n-1 commas 

or carriage returns before the ALT MODE. 



23 



4. OPERATING PROCEDURES 

Place the main program in the reader, depress the tape feed switch to clear the end-of-tape 
flag, and type the command string. 

When the main program has been loaded, the Loader types tP. 

Place any subroutines to be loaded in the reader, depress the tape feed switch and type 
CTRL P. 

When all subroutines have been loaded, place the l/O library (tape 1 of 3) in the reader, 
depress the tape feed switch, and type CTRL P. 

MACRO programs (that do not require programs from the FORTRAN library): 

If the loader has not been satisfied at the end of the I/O library, place the short EOF 

tape (included with library tape) in the reader, push the feed button, and type control P. 

FORTRAN programs (and MACRO programs that require programs from the FORTRAN library): 

After the I/O library has been read, load the FORTRAN library (tapes 2 and 3) in the same 

manner (tape 3 includes EOF). 

If the loader is not satisfied by the library tapes, a subroutine has been omitted. The loader 
types out the names and addresses of all programs and library subroutines loaded. A . LOAD 3 error 
message and a zero address indicates a missing subroutine. (If this happens, it is necessary to reload 
DDT.) 

When loading has been successfully completed, DDT types: 

DDT 
> 
Debugging may now begin. 

Following is a summary of DDT commands. For detailed information on the operation of 
each command, see the DDT manual. 

SUMMARY OF COMMANDS 

Linkage Characters 
+ Arithmetic plus 

Arithmetic minus 
(space) Field separator 

Breakpoints 
k n" Insert breakpoint at location k, assign number n (1-4) 

n" Remove breakpoint number n 

" Remove all existing breakpoints 
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Breakpoints (Cont) 
! Restart from breakpoint 

n Restart from breakpoint, wait n times before reentering breakpoint 

tT Interrupt processing, go to DDT-9 

Examinations and Modifications 



k/ Open location k 

li (Carriage return) Close the location 

i (Line feed) Close the location, open next location 

t (Up arrow) Close the location, open the preceding location. 

tZ (CTRL Z) Close the location, open addressed location, continue 

original sequence 

tA (CTRL A) Close the location, open addressed location, start new 

sequence 

tX (CTRL X) Close the location, open the location addressed by 15-bit 

transfer vector, start new sequence 

NUM$ Type contents as 6-digit octal numbers 

TV$ Type contents as transfer vectors (15-bit addresses) 

SYM$ Type contents as symbolic instructions (assumed if unspecified) 

: Retype in alternate mode (NUM$, SYM$) 

= Retype as transfer vector 

REL$ Type addresses as relative to defined symbols (assumed if unspecified) 

RLC$ Type addresses as relocatable numbers 

ABS$ Type addresses as absolute numbers 

Starts and Restarts 



' Starts user's program at normal starting point 

k' Starts user's program at location k 

! Restarts user's program from breakpoint 

n' Restarts user's program from breakpoint, waits n times before re- 

entering breakpoint 

tT (CTRL T) Interrupt processing 

Searching Operations 



k^EQ$ Search for words equal to k 

k,_,UN$ Search for words not equal to k 

ku_.ADR$ Search for instructions with effective address equal to k 
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Special DDT-9 Locations 

AC$ Holds AC at a breakpoint 

LNK$ Status of Link at a breakpoint 

MSK$ Contains search mask 

LO$ Lower limit of search 

HI$ Upper limit of search 

PA$ First unused location in patch area 

AX$ Number of auto-index used by breakpoints 

RF$ Current relocation factor 

SA$ Normal starting address 

Bn$ Address of breakpoint n 

Symbol Definition 



s) Assign symbol s to the current location 

k(s) Assign symbol s to location k 

Patch File Output 



PFO$ 


Patch file output 


k^PFO$ 


Single location k patch file output 


SN$$ 


Save new symbols 


PFE$ 


Close patch file output 




Patch File Input 



PFI$ Read patch file 

Coresident Subroutines 



K HDR$ Use symbol table and relocation factor of subroutine k 

HDR$ Use symbol table and relocation factor of main program 

Miscellaneous Features 



Q$ Contents of currently open location 

Address of currently open or most recently opened location 
& Bypass mnemonic instruction lookup 

k"^ Execute the instruction k 

tU (CTRL U) Cancel the line 

tT (CTRL T) Interrupt processing 
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ERROR CONDITIONS 

a. Loader errors 
.LOAD 1 

. LOAD 2 
. LOAD 3 
. LOAD 4 

b. DDT running errors 
OVERFLOW 
ERROR 



memory overflow 

input data error 

unsatisfied global symbol (missing program) 

illegal .DAT slot request by user program 

too many new symbols defined - current entry ignored 

read error on patch file input - all patches loaded be- 
fore error are good 



? general error indicator - current entry ignored 

undefined symbol 
address above core 
incorrect command 
illegal character 

c. I/O errors 

.lOPS 4 Device not ready - ready device and type CTRL R. 

.lOPS 00-30 Unrecoverable during loading phase; returns to DDT during debug phase, 

RESTART PROCEDURE 



CTRL T (tT) Restarts DDT; if halted, DDT must be reloaded. 

CTRL P (tP) When typing command string to the Loader, restarts the Loader. 



EXAMPLES 

LOADER 

>EX1 (ALT MODE) 
EXl 14455 

DDT 
> 

LOADER 

>EX2,SUB (ALT MODE) 



EX2 

tPtP 

SUB 

tPtP 

tPtP 

.DA 

tPtP 



14746 



14703 



14634 



Place subroutine in reader and type control P. 

Place I/O library in reader and type control P. 

Place FORTRAN library tape 2 in reader and type control P. 

Place FORTRAN library tape 3 in reader and type control P. 
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BCDIO 


11641 


STOP 


11626 


SPMSG 


11532 


FIOPS 


11002 


OTSER 


10674 


REAL 


07741 


DDT 




> 




LOADER 




> (ALT MODE) 


EXl 


14455 


DDT 




>NUM$ 




>AC$/ 


000000 


LNK$/ 


000000 


MSK$/ 


777777 


LO$/ 


014455 = 


HI$/ 


015007 = 


PA$/ 


002420 


AX$/ 


000017 


RF$/ 


014455 


SA$/ 


414455 = 


Bl$/ 


000000 


B2$/ 


000000 


B3$/ 


000000 


B4$/ 


000000 


>BEGIN/ 


000776 


>SYM$ 




>./ CAL+776 


BEGIN+1/ 


CAL+1 


BEGIN+2/ 


CAL+ 14455 


BEGIN+3/ 


CAL 


BEGIN+4/ 


LAC END+1 


READ-5/ 


JMS TYPE 


READ-4/ 


LAC END+2 


END+2/ 


LAW 17774 


READ-3/ 


DAC COL 



NOTE 
After placing tape in reader, push the tape feed button 
to clear the end-of-tape flag. First tP is signal to load 
next tape. Second tP is acknowledgment of user typing 
control P. 



Program name not needed with paper tape input to loader, 



BEGIN 
EN[>M5 



BEGIN 



Low limit of program. 

High limit of program. 

Low limit of available memory, 

Relocation factor. 
Starting address. 



BEGIN 
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APPENDIX 1 
DEVICE ASSIGNMENTS 

Device Assignment Tables (.DAT) 

In the I/O Monitor version, the . DAT slot assignments are permanent and cannot be changed.* 
The negative .DAT slots are those used by the system and the user need not be concerned with them. 
The positive .DAT slots, hov/ever, are user .DAT slots. When v/riting programs which are to be run 
within the system, the user should be careful to use the correct .DAT slot numbers. 



. DAT SLOT 


DEVICE 


HANDLER 


USE 


1 


TTY Printer 


(TTA.) 


Teleprinter Output 


2 


TTY Keyboard 


(TTA.) 


Keyboard Input 


3 


Paper Tape Reader 


(PRA.) 


Input 


4 


TTY Printer 


(TTA.) 


Listing 


5 


Paper Tape Punch 


(PPA.) 


Output 


6 


Paper Tape Reader 


(PRA.) 


Scratch 


7 


Paper Tape Punch 


(PPA.) 


Scratch 


10 


Paper Tape Reader 


(PRA.) 


Scratch 



For example, if the user desires to output to the teleprinter from a FORTRAN IV program, 
the WRITE statement should read: 

WRITE (1, 10), where 1 is .DAT slot 1 and 10 is the FORMAT statement number. 



*Special software will be furnished by DEC for special systems using card reader, line printer, etc 
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APPENDIX 2 
PDP-9 ASCII CHARACTER SET 

Listed below are the ASCII characters Interpreted by the PDP-9 Monitor and system programs 
as meaningful data input or as control characters. 





00-37 


40-77 


100-137 


140-177 






ASCII 


ASCII 


ASCII 


ASCII 






CHAR. 


CHAR. 


CHAR. 


CHAR. 







NUL 


SP 


\ 







1 


SOH (tA) 




A 




1 


2 




" 


B 




2 


3 


EXT (tC) 


# 


C 




3 


4 




$ 


D 




4 


5 




% 


E 




5 


6 




& 


F 




6 


7 




1 


G 




7 


10 




( 


H 




10 


11 


HT 


) 


I 




11 


12 


LF 


* 


J 




12 


13 


VT 


+ 


K 




13 


14 


FF 


/ 


L 




14 


15 


CR 


- 


M 




15 


16 




, 


N 




16 


17 




/ 


O 




17 


20 


DLE(tP) 





P 




20 


21 


(tQ) 


1 


Q 




21 


22 


DC2(tR) 


2 


R 




22 


23 


DC3(tS) 


3 


S 




23 


24 


DC4(tT) 


4 


T 




24 


25 


NACK(tU) 


5 


U 




25 


26 




6 


V 




26 


27 




7 


W 




27 


30 


CNCL(tX) 


8 


X 




30 


31 




9 


Y 




31 


32 


SS (tZ) 




Z 




32 


33* 


ESC 


1 






33 


34 




< 






34 


35 




= 




ESC 


35 


36 


RS(t) 


> 


A or t 


ESC 


36 


37 




? 




delete (RO) 


37 



*Codes 33, 176, 175 are interpreted as ESC (ALT MODE) and are converted on input to code 175 by 
lOPS handlers. 
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APPENDIX 3 
MACRO-9 ERROR DIAGNOSTICS 



Flag Meaning 

A Error in direct Symbol Table assignment, assignment ignored. 

B Memory Bank error. 

D The statement contains a reference to a multiply defined symbol. It is 

assembled with the first value defined. 

E Erroneous results may have been produced. Will also occur on unde- 

fined .END value. 

I Line ignored. (Redundant Pseudo-op) 

L Literal phasing error. 

M An attempt is made to define a symbol which has already been defined, 

The symbol retains its original value. 

N Error in number usage. 

P Phase error. PASS! value does not equal PASS2 value of a symbol. 

PASSl value will be used. 

Q Questionable line. 

R Possible relocation error. 

S Symbol error. An illegal character was encountered and ignored. 

U An undefined symbol was encountered. 

W Line overflow during macro expansion. 

X Illegal usage of macro name. 
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APPENDIX 4 

MACRO -9 
PERMANENT SYMBOL TABLE 



Memory Reference 



CAL 

DAC 

JMS 

DZM 

LAC 

XOR 

ADD 

TAD 

XCT 

ISZ 

AND 

SAD 

JMP 



000000 
040000 
100000 
140000 
200000 
240000 
300000 
340000 
400000 
440000 
500000 
540000 
600000 



Operate 



OPR 

NOP 

CMA 

CML 

OAS 

RAL 

RAR 

HLT 

XX 

SMA 

SZA 

SNL 

SML 

SKP 

SPA 

SNA 

SZL 

SPL 

RTL 

RTR 

CLL 

STL 

CCL 

RCL 

RCR 

CLA 

CLC 

LAS 

LAT 



740000 
740000 
740001 
740002 
740004 
740010 
740020 
740040 
740040 
740100 
740200 
740400 
740400 
741000 
741100 
741200 
741400 
741400 
742010 
742020 
744000 
744002 
744002 
744010 
744020 
750000 
750001 
750004 
750004 



Operate (Cent) 


GLK 


750010 


LAW 


760000 


EAE Type 


KE09A 


EAE 


640000 


OSC 


640001 


OMQ 


640002 


CMQ 


640004 


DIV 


640323 


NORM 


640444 


LRS 


640500 


LLS 


640600 


ALS 


640700 


LACS 


641001 


LACQ 


641002 


ABS 


644000 


DIVS 


644323 


CLQ 


650000 


FRDIV 


650323 


LMQ 


652000 


MUL 


653122 


I DIV 


653323 


FRDIVS 


654323 


MULS 


657122 


I DIVS 


657323 


NORMS 


660444 


LRSS 


660500 


LLSS 


660600 


ALSS 


660700 


GSM 


664000 


I/O States 


lOT 


700000 


lORS 


700314 


Interrupt 


lOF 


700002 


ION 


700042 


CAP 


703302 



Automatic Priority 
Interrupt Type KF09A 

DBK 703304 

DBR 703344 

SPI 705501 

ISA 705504 

Memory Extension 
Control Type KE09B 



SEM 
EEM 
LEM 



707701 
707702 
707704 



Memory Protect 
Type KX09A 



MPSK 
MPLU 
MPLD 
MPEU 



701701 
701702 
701704 
701742 
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APPENDIX 5 
SYSTEM RESTART 

SYSTEM RESTART can be used to attempt to restart a system program (excluding DDT and the 
Loader) which has halted during operation. It is most easily used if the symbolic program (SYSTEM 
RESTART), shown on the following page, has been punched onto tape and assembled by MACRO-9. If 
this has been done and a binary tape is available, proceed as follows: 

1 . Place binary tape in reader. 

2. Depress the tape-feed switch to clear the end-of-tape flag. 

3. Set address switches to 17720. 

4. Press I/O RESET. 

5. Press READ IN. 

If a binary tape is not available, SYSTEM RESTART may be entered through the AC switches, 
using the deposit key. When this has been done, proceed as follows: 

1 . Set address switches to 17720. 

2. Press I/O RESET. 

3. Press START. 

If the restart attempt is successful, the effect will be the same as a CTRL P restart. Further 
restarts are possible without reloading SYSTEM RESTART by the following procedure. 

1. Set address switches to 17720. 

2. Press I/O RESET. 

3. Press START. 

If the restart attempt fails, it will be necessary to reload the system program tape. 
Since a halt usually indicates a rather serious problem, SYSTEM RESTART will often fail to 
restart the program. 

Two instances in which it will work: 

1 . When the user has accidentally typed an ALT MODE instead of a carriage return as a 
command string terminator, and wishes to regain the program for another run. 

2. After an lOPS 3 error if the offending device flag has been removed. 
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• TITLE SYSTEM RESTART 








.FULL 


17720 






.LOG 17720 


17720 


707702 


D 


EEM 


17721 


237734 




LAC* E 


17722 


057731 




DAC A 


17723 


703302 




CAF 


17724 


700042 




ION 


17725 


237732 




LAC* B 


17726 


705504 




ISA 


17727 


177733 




DZM* C 


17730 


637731 




JMP* A 


17731 


000000 


A 





17732 


000006 


B 


6 


17733 


001413 


C 


1413 


17734 


000632 


E 


632 




017720 




.END D 

NO ERROR LINES 
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APPENDIX 6 
EXPLANATION OF lOPS ERROR CODES 



ERROR CODE 

1 
2 
3 
4 

5 

6 

7 
30 
31 
32 
33 
34 



ERROR 
Illegal Function CAL 



CAL 



Illegal 



. DAT slot error 

Illegal interrupt 

Device not ready (type 
CTRL R when ready) 

Illegal .SETUP CAL 

Illegal handler function 

Illegal data mode 

API software level error 

Non-existent memory reference 

Memory protect violation 

Memory parity error 

Power fail with no skip setup 



ERROR DATA 
CAL address 
CAL address 
CAL address 
l/O status register 



CAL address 
CAL address 
CAL address 
API status register 
Program counter 
Program counter 
Program counter 
Program counter 
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APPENDIX 7 
FORTRAN IV ERROR LIST 



Error Code 

X Syntax error 

V Variable/constant mode error 

N Statement number error 

S Argument/subscript error 

F FORMAT statement error 

I Character/statement/term error 

D DO loop error 

T Table overflow 

L Nesting error 

M Magnitude error 



COMMON/EQUIVALENCE/ 
DIMENSION/DATA Statement 
error 



FUNCTION/SUBROUTINE/ 
EXTERNAL/CALL statement error 

Hollerith error 



Cause 

Statement cannot be recognized as a properly con- 
structed FORTRAN IV statement. 

Illegal mode mixing. Missing constant, variable or 
exponent, or illegal matching of constants or vari- 
ables in a DATA statement. 

Phase error, number more than 5 digits, no statement 
number where one is required, statement shouldn't be 
labeled or doubly defined statement numbers. 

Missing argument or subscript, illegal use of sub- 
scripts, illegal construction of subscripted variable, 
more than 3 subscripts or stated number of subscripts 
does not agree with declared number. 

Illegal FORMAT specification or illegal construction 
of FORMAT statement. 

Illegal character, unrecognizable statement, illegal 
statement for program type, statement out of order 
or improper statement preceding END statement. 

Illegal DO construction or illegal statement termi- 
nating DO LOOP. 

Symbol/constant/arg (I)/OP(I) table limits exceeded. 

Illegal nesting or DO nesting too deep. 

Program exceeds 8192 words, maximum number of 
dummy arguments or EQUIVALENCE classes exceeded, 
or constant/variable exceeds specified limits. 

Illegal construction of statement, illegal EQUIVA- 
LENCE relationships, illegal COMMON declaration 
or non-common storage declared in BLOCK DATA 
subprogram. 

Illegal use of FUNCTION/SUBROUTINE name, out 
of order, or illegal variable for EXTERNAL decla- 
ration. 

Hollerith data illegal in this statement or illegal use 
of Hollerith constant. 
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